Changes the maximum setting of a control and, if appropriate, redraws it accordingly.

void SetControl32BitMaximum (
    ControlRef theControl, 
    SInt32 newMaximum
);

theControl

A handle to the control whose maximum setting you wish to change.

newMaximum

The new maximum setting of the control. In general, to avoid unpredictable behavior, do not set the maximum control value lower than the current minimum value.

DISCUSSION

Your application may use the SetControl32BitMaximum function to set a 32-bit value as the maximum setting for a control.

If your application uses a 32-bit control maximum value, it should not attempt to obtain this value by calling the pre–Mac OS 8.5 function GetControlMaximum or by accessing the contrlMax field of the ControlRecord structure, because the stored 16-bit value will not accurately reflect the current 32-bit control value. Instead, use the function GetControl32BitMaximum.

VERSION NOTES

This function is available with Mac OS 8.5 and later.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.5 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)